Skip to content

feat: límites del diseño en el código + arreglos Pi/WSL + v3.5.0 - #27

Merged
lacasoft merged 4 commits into
masterfrom
feat/limites-al-codigo
Nov 3, 2026
Merged

lacasoft merged 4 commits into
masterfrom
feat/limites-al-codigo

Conversation

@lacasoft

@lacasoft lacasoft commented Nov 3, 2026 •

Copy link
Copy Markdown
Owner

Summary

Lleva al código lo que system-design-kit 1.4 y 1.5 agregaron al diseño, y corrige dos fallas que salieron del uso real. Release v3.5.0. Funciona igual en Claude Code y en Pi.

La ficha de responsabilidades del diseño llega al código. /project-context traslada desde un design.md:

Del diseño A CLAUDE.project.md
Ficha de responsabilidades Arquitectura → Responsabilidades y límites, tal cual
Dueños de reglas y datos Reglas de límite en Reglas de negocio: qué componente decide qué, y que ningún contexto escribe los datos de otro
Flujos críticos Testing → Tests de recuperación: uno por cada paso con efecto desconocido o con recuperación, como lista para tdd
Contextos y propiedad Modelo / dominio, con un módulo por contexto si el repo todavía no tiene estructura

Además:

  • La baseline (§7) pide respetar esos límites: cada regla va en su dueño, no en el controlador, el adaptador ni el job, y si una tarea exige cruzar un límite, se dice antes.
  • La plantilla de CLAUDE.project.md pide las responsabilidades en Arquitectura. La detección de "plantilla vacía" ignora los comentarios, así que los proyectos existentes no cambian.

Arreglos

  • En Pi, las skills se saltaban su referencia. En la prueba con Sonnet, /skill:project-context no leyó desde-design.md e improvisó el mapeo: sin ficha y con los tests de recuperación en una línea. Una instrucción escrita a media frase se salta, así que ahora project-context y owasp-review piden leer su referencia como paso explícito y con la ruta completa. Repetida la prueba, la leyó: la ficha llegó con sus 4 componentes y quedaron 6 tests de recuperación.
  • WSL con Node de Windows: el instalador fallaba con EPERM en C:\Windows. Ahora lo detecta antes de escribir nada y explica qué hacer.
  • desde-design.md aclara que en Pi la ruta del diseño se lee sin --add-dir.

Test plan

  • npm run validate (58 comprobaciones) y node --test: 199 pruebas en verde y 7 de integración omitidas sin PI_BIN. Con Pi 1.4.0 pasan las 206. Incluye una prueba nueva de detección del Node de Windows: C:\Windows, subcarpetas, lanzado desde \\wsl…, sin confundir carpetas de nombre parecido ni afectar Linux.
  • Claude Code real: /project-context de un diseño de reserva de salas con ficha y flujos críticos (system-design-kit 1.5).
    • La ficha quedó tal cual en Arquitectura → Responsabilidades y límites.
    • Las reglas de límite pasaron a Reglas de negocio, por ejemplo "el Liberador solo dispara; no decide" y "ningún componente escribe el estado de otro".
    • Quedaron 7 tests de recuperación con qué se simula y qué evidencia de cierre se comprueba, y 2 ADRs.
    • Dejó en Pendiente de confirmar huecos reales del diseño, como la carrera entre el check-in y la liberación.
  • Pi 1.4.0 con Sonnet vía API (USD 0.29 entre las dos corridas): antes del arreglo, no leía la referencia; después, ficha completa y 6 tests de recuperación.
  • CI en verde, incluido el job pi.

Después del merge: tag anotado v3.5.0 y smoke con npx -y github:lacasoft/dev-starter-kit#v3.5.0.

lacasoft added 4 commits November 3, 2026 21:50
Con WSL y Node solo en Windows, npx corre en Windows, CMD cae a C:\Windows y el
instalador fallaba con EPERM. Ahora lo detecta antes de escribir nada y explica
cómo instalar Node dentro de WSL.
Una instrucción de leer un archivo auxiliar escrita a media frase se salta en
Pi: project-context no leía desde-design.md e improvisaba el mapeo. Ahora
project-context y owasp-review piden leer su referencia con la ruta completa, y
desde-design.md aclara que en Pi la ruta del diseño se lee sin --add-dir.
/project-context copia la ficha a Arquitectura → Responsabilidades y límites,
las reglas de límite a Reglas de negocio, los flujos críticos a Testing → Tests
de recuperación (lista para tdd) y los contextos y propiedad a Modelo / dominio.
La baseline pide respetar esos límites y avisar antes de cruzarlos.
@lacasoft
lacasoft merged commit 4b3a735 into master Nov 3, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant